---
id: TASK-012
title: 'release verb: -m flag for custom annotated-tag message'
status: "\U0001F7E6 Backlog"
assignee: []
created_date: '2026-06-29 22:08'
labels:
  - feature
dependencies: []
priority: low
ordinal: 12000
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
custard release vX.Y.Z hardcodes the annotated-tag message to the version string (internal/cli/verbs.go:166 — 'git tag -a <ver> -m <ver> <commit>'). Release() only reads args[0]; extra args like -m "msg" are silently ignored. Add a -m/--message flag so the release can carry a real message; fall back to the version when absent.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [ ] #1 custard release vX.Y.Z -m "msg" sets the annotated tag message to msg
- [ ] #2 no -m given falls back to the version string (current behavior, unchanged)
- [ ] #3 unknown/extra args error instead of being silently ignored
<!-- AC:END -->